home *** CD-ROM | disk | FTP | other *** search
- ///////////////////////////////////////////////////////////////////////////
- //
- // Copyright (C) Microsoft Corporation. All Rights Reserved.
- //
- // File: d3dx9core.h
- // Content: D3DX core types and functions
- //
- ///////////////////////////////////////////////////////////////////////////
-
- #include "d3dx9.h"
-
- #ifndef __D3DX9CORE_H__
- #define __D3DX9CORE_H__
-
- ///////////////////////////////////////////////////////////////////////////
- // D3DX_SDK_VERSION:
- // -----------------
- // This identifier is passed to D3DXCheckVersion in order to ensure that an
- // application was built against the correct header files and lib files.
- // This number is incremented whenever a header (or other) change would
- // require applications to be rebuilt. If the version doesn't match,
- // D3DXCreateVersion will return FALSE. (The number itself has no meaning.)
- ///////////////////////////////////////////////////////////////////////////
-
- #define D3DX_VERSION 0x0900
- #define D3DX_SDK_VERSION 9
-
- #ifdef __cplusplus
- extern "C" {
- #endif //__cplusplus
-
- BOOL WINAPI
- D3DXCheckVersion(UINT D3DSdkVersion, UINT D3DXSdkVersion);
-
-
-
- ///////////////////////////////////////////////////////////////////////////
- // D3DXGetDriverLevel:
- // Returns driver version information:
- //
- // 700 - DX7 level driver
- // 800 - DX8 level driver
- // 900 - DX9 level driver
- ///////////////////////////////////////////////////////////////////////////
- UINT WINAPI
- D3DXGetDriverLevel(LPDIRECT3DDEVICE9 pDevice);
-
- #ifdef __cplusplus
- }
- #endif //__cplusplus
-
-
- ///////////////////////////////////////////////////////////////////////////
- // ID3DXBuffer:
- // ------------
- // The buffer object is used by D3DX to return arbitrary size data.
- //
- // GetBufferPointer -
- // Returns a pointer to the beginning of the buffer.
- //
- // GetBufferSize -
- // Returns the size of the buffer, in bytes.
- ///////////////////////////////////////////////////////////////////////////
-
- typedef interface ID3DXBuffer ID3DXBuffer;
- typedef interface ID3DXBuffer *LPD3DXBUFFER;
-
- // {932E6A7E-C68E-45dd-A7BF-53D19C86DB1F}
- DEFINE_GUID(IID_ID3DXBuffer,
- 0x932e6a7e, 0xc68e, 0x45dd, 0xa7, 0xbf, 0x53, 0xd1, 0x9c, 0x86, 0xdb, 0x1f);
-
- #undef INTERFACE
- #define INTERFACE ID3DXBuffer
-
- DECLARE_INTERFACE_(ID3DXBuffer, IUnknown)
- {
- // IUnknown
- STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
- STDMETHOD_(ULONG, AddRef)(THIS) PURE;
- STDMETHOD_(ULONG, Release)(THIS) PURE;
-
- // ID3DXBuffer
- STDMETHOD_(LPVOID, GetBufferPointer)(THIS) PURE;
- STDMETHOD_(DWORD, GetBufferSize)(THIS) PURE;
- };
-
-
-
- ///////////////////////////////////////////////////////////////////////////
- // ID3DXFont:
- // ----------
- // Font objects contain the textures and resources needed to render
- // a specific font on a specific device.
- //
- // Begin -
- // Prepartes device for drawing text. This is optional.. if DrawText
- // is called outside of Begin/End, it will call Begin and End for you.
- //
- // DrawText -
- // Draws formatted text on a D3D device. Some parameters are
- // surprisingly similar to those of GDI's DrawText function. See GDI
- // documentation for a detailed description of these parameters.
- //
- // End -
- // Restores device state to how it was when Begin was called.
- //
- // OnLostDevice, OnResetDevice -
- // Call OnLostDevice() on this object before calling Reset() on the
- // device, so that this object can release any stateblocks and video
- // memory resources. After Reset(), the call OnResetDevice().
- //
- ///////////////////////////////////////////////////////////////////////////
-
- typedef interface ID3DXFont ID3DXFont;
- typedef interface ID3DXFont *LPD3DXFONT;
-
-
- // {4AAE6B4D-D15F-4909-B09F-8D6AA34AC06B}
- DEFINE_GUID( IID_ID3DXFont,
- 0x4aae6b4d, 0xd15f, 0x4909, 0xb0, 0x9f, 0x8d, 0x6a, 0xa3, 0x4a, 0xc0, 0x6b);
-
-
- #undef INTERFACE
- #define INTERFACE ID3DXFont
-
- DECLARE_INTERFACE_(ID3DXFont, IUnknown)
- {
- // IUnknown
- STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
- STDMETHOD_(ULONG, AddRef)(THIS) PURE;
- STDMETHOD_(ULONG, Release)(THIS) PURE;
-
- // ID3DXFont
- STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
- STDMETHOD(GetLogFont)(THIS_ LOGFONT* pLogFont) PURE;
-
- STDMETHOD(Begin)(THIS) PURE;
- STDMETHOD_(INT, DrawTextA)(THIS_ LPCSTR pString, INT Count, LPRECT pRect, DWORD Format, D3DCOLOR Color) PURE;
- STDMETHOD_(INT, DrawTextW)(THIS_ LPCWSTR pString, INT Count, LPRECT pRect, DWORD Format, D3DCOLOR Color) PURE;
- STDMETHOD(End)(THIS) PURE;
-
- STDMETHOD(OnLostDevice)(THIS) PURE;
- STDMETHOD(OnResetDevice)(THIS) PURE;
- };
-
- #ifndef DrawText
- #ifdef UNICODE
- #define DrawText DrawTextW
- #else
- #define DrawText DrawTextA
- #endif
- #endif
-
-
- #ifdef __cplusplus
- extern "C" {
- #endif //__cplusplus
-
- HRESULT WINAPI
- D3DXCreateFont(
- LPDIRECT3DDEVICE9 pDevice,
- HFONT hFont,
- LPD3DXFONT* ppFont);
-
-
- HRESULT WINAPI
- D3DXCreateFontIndirect(
- LPDIRECT3DDEVICE9 pDevice,
- CONST LOGFONT* pLogFont,
- LPD3DXFONT* ppFont);
-
- #ifdef __cplusplus
- }
- #endif //__cplusplus
-
-
-
-
- ///////////////////////////////////////////////////////////////////////////
- // ID3DXSprite:
- // ------------
- // This object intends to provide an easy way to drawing sprites using D3D.
- //
- // Begin -
- // Prepares device for drawing sprites
- //
- // Draw, DrawAffine, DrawTransform -
- // Draws a sprite in screen-space. Before transformation, the sprite is
- // the size of SrcRect, with its top-left corner at the origin (0,0).
- // The color and alpha channels are modulated by Color.
- //
- // End -
- // Restores device state to how it was when Begin was called.
- //
- // OnLostDevice, OnResetDevice -
- // Call OnLostDevice() on this object before calling Reset() on the
- // device, so that this object can release any stateblocks and video
- // memory resources. After Reset(), the call OnResetDevice().
- ///////////////////////////////////////////////////////////////////////////
-
- typedef interface ID3DXSprite ID3DXSprite;
- typedef interface ID3DXSprite *LPD3DXSPRITE;
-
-
- // {B07EC84A-8D35-4e86-A9A0-8DFF21D71075}
- DEFINE_GUID( IID_ID3DXSprite,
- 0xb07ec84a, 0x8d35, 0x4e86, 0xa9, 0xa0, 0x8d, 0xff, 0x21, 0xd7, 0x10, 0x75);
-
-
- #undef INTERFACE
- #define INTERFACE ID3DXSprite
-
- DECLARE_INTERFACE_(ID3DXSprite, IUnknown)
- {
- // IUnknown
- STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
- STDMETHOD_(ULONG, AddRef)(THIS) PURE;
- STDMETHOD_(ULONG, Release)(THIS) PURE;
-
- // ID3DXSprite
- STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
-
- STDMETHOD(Begin)(THIS) PURE;
-
- STDMETHOD(Draw)(THIS_ LPDIRECT3DTEXTURE9 pSrcTexture,
- CONST RECT* pSrcRect, CONST D3DXVECTOR2* pScaling,
- CONST D3DXVECTOR2* pRotationCenter, FLOAT Rotation,
- CONST D3DXVECTOR2* pTranslation, D3DCOLOR Color) PURE;
-
- STDMETHOD(DrawTransform)(THIS_ LPDIRECT3DTEXTURE9 pSrcTexture,
- CONST RECT* pSrcRect, CONST D3DXMATRIX* pTransform,
- D3DCOLOR Color) PURE;
-
- STDMETHOD(End)(THIS) PURE;
-
- STDMETHOD(OnLostDevice)(THIS) PURE;
- STDMETHOD(OnResetDevice)(THIS) PURE;
- };
-
-
- #ifdef __cplusplus
- extern "C" {
- #endif //__cplusplus
-
-
- HRESULT WINAPI
- D3DXCreateSprite(
- LPDIRECT3DDEVICE9 pDevice,
- LPD3DXSPRITE* ppSprite);
-
- #ifdef __cplusplus
- }
- #endif //__cplusplus
-
-
-
-
- ///////////////////////////////////////////////////////////////////////////
- // ID3DXRenderToSurface:
- // ---------------------
- // This object abstracts rendering to surfaces. These surfaces do not
- // necessarily need to be render targets. If they are not, a compatible
- // render target is used, and the result copied into surface at end scene.
- //
- // BeginScene, EndScene -
- // Call BeginScene() and EndScene() at the beginning and ending of your
- // scene. These calls will setup and restore render targets, viewports,
- // etc..
- //
- // OnLostDevice, OnResetDevice -
- // Call OnLostDevice() on this object before calling Reset() on the
- // device, so that this object can release any stateblocks and video
- // memory resources. After Reset(), the call OnResetDevice().
- ///////////////////////////////////////////////////////////////////////////
-
- typedef struct _D3DXRTS_DESC
- {
- UINT Width;
- UINT Height;
- D3DFORMAT Format;
- BOOL DepthStencil;
- D3DFORMAT DepthStencilFormat;
-
- } D3DXRTS_DESC;
-
-
- typedef interface ID3DXRenderToSurface ID3DXRenderToSurface;
- typedef interface ID3DXRenderToSurface *LPD3DXRENDERTOSURFACE;
-
-
- // {0D014791-8863-4c2c-A1C0-02F3E0C0B653}
- DEFINE_GUID( IID_ID3DXRenderToSurface,
- 0xd014791, 0x8863, 0x4c2c, 0xa1, 0xc0, 0x2, 0xf3, 0xe0, 0xc0, 0xb6, 0x53);
-
-
- #undef INTERFACE
- #define INTERFACE ID3DXRenderToSurface
-
- DECLARE_INTERFACE_(ID3DXRenderToSurface, IUnknown)
- {
- // IUnknown
- STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
- STDMETHOD_(ULONG, AddRef)(THIS) PURE;
- STDMETHOD_(ULONG, Release)(THIS) PURE;
-
- // ID3DXRenderToSurface
- STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
- STDMETHOD(GetDesc)(THIS_ D3DXRTS_DESC* pDesc) PURE;
-
- STDMETHOD(BeginScene)(THIS_ LPDIRECT3DSURFACE9 pSurface, CONST D3DVIEWPORT9* pViewport) PURE;
- STDMETHOD(EndScene)(THIS_ DWORD MipFilter) PURE;
-
- STDMETHOD(OnLostDevice)(THIS) PURE;
- STDMETHOD(OnResetDevice)(THIS) PURE;
- };
-
-
- #ifdef __cplusplus
- extern "C" {
- #endif //__cplusplus
-
- HRESULT WINAPI
- D3DXCreateRenderToSurface(
- LPDIRECT3DDEVICE9 pDevice,
- UINT Width,
- UINT Height,
- D3DFORMAT Format,
- BOOL DepthStencil,
- D3DFORMAT DepthStencilFormat,
- LPD3DXRENDERTOSURFACE* ppRenderToSurface);
-
- #ifdef __cplusplus
- }
- #endif //__cplusplus
-
-
-
-
- ///////////////////////////////////////////////////////////////////////////
- // ID3DXRenderToEnvMap:
- // --------------------
- // This object abstracts rendering to environment maps. These surfaces
- // do not necessarily need to be render targets. If they are not, a
- // compatible render target is used, and the result copied into the
- // environment map at end scene.
- //
- // BeginCube, BeginSphere, BeginHemisphere, BeginParabolic -
- // This function initiates the rendering of the environment map. As
- // parameters, you pass the textures in which will get filled in with
- // the resulting environment map.
- //
- // Face -
- // Call this function to initiate the drawing of each face. For each
- // environment map, you will call this six times.. once for each face
- // in D3DCUBEMAP_FACES.
- //
- // End -
- // This will restore all render targets, and if needed compose all the
- // rendered faces into the environment map surfaces.
- //
- // OnLostDevice, OnResetDevice -
- // Call OnLostDevice() on this object before calling Reset() on the
- // device, so that this object can release any stateblocks and video
- // memory resources. After Reset(), the call OnResetDevice().
- ///////////////////////////////////////////////////////////////////////////
-
- typedef struct _D3DXRTE_DESC
- {
- UINT Size;
- UINT MipLevels;
- D3DFORMAT Format;
- BOOL DepthStencil;
- D3DFORMAT DepthStencilFormat;
- } D3DXRTE_DESC;
-
-
- typedef interface ID3DXRenderToEnvMap ID3DXRenderToEnvMap;
- typedef interface ID3DXRenderToEnvMap *LPD3DXRenderToEnvMap;
-
-
- // {1561135E-BC78-495b-8586-94EA537BD557}
- DEFINE_GUID( IID_ID3DXRenderToEnvMap,
- 0x1561135e, 0xbc78, 0x495b, 0x85, 0x86, 0x94, 0xea, 0x53, 0x7b, 0xd5, 0x57);
-
-
- #undef INTERFACE
- #define INTERFACE ID3DXRenderToEnvMap
-
- DECLARE_INTERFACE_(ID3DXRenderToEnvMap, IUnknown)
- {
- // IUnknown
- STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
- STDMETHOD_(ULONG, AddRef)(THIS) PURE;
- STDMETHOD_(ULONG, Release)(THIS) PURE;
-
- // ID3DXRenderToEnvMap
- STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
- STDMETHOD(GetDesc)(THIS_ D3DXRTE_DESC* pDesc) PURE;
-
- STDMETHOD(BeginCube)(THIS_
- LPDIRECT3DCUBETEXTURE9 pCubeTex) PURE;
-
- STDMETHOD(BeginSphere)(THIS_
- LPDIRECT3DTEXTURE9 pTex) PURE;
-
- STDMETHOD(BeginHemisphere)(THIS_
- LPDIRECT3DTEXTURE9 pTexZPos,
- LPDIRECT3DTEXTURE9 pTexZNeg) PURE;
-
- STDMETHOD(BeginParabolic)(THIS_
- LPDIRECT3DTEXTURE9 pTexZPos,
- LPDIRECT3DTEXTURE9 pTexZNeg) PURE;
-
- STDMETHOD(Face)(THIS_ D3DCUBEMAP_FACES Face, DWORD MipFilter) PURE;
- STDMETHOD(End)(THIS_ DWORD MipFilter) PURE;
-
- STDMETHOD(OnLostDevice)(THIS) PURE;
- STDMETHOD(OnResetDevice)(THIS) PURE;
- };
-
-
- #ifdef __cplusplus
- extern "C" {
- #endif //__cplusplus
-
- HRESULT WINAPI
- D3DXCreateRenderToEnvMap(
- LPDIRECT3DDEVICE9 pDevice,
- UINT Size,
- UINT MipLevels,
- D3DFORMAT Format,
- BOOL DepthStencil,
- D3DFORMAT DepthStencilFormat,
- LPD3DXRenderToEnvMap* ppRenderToEnvMap);
-
- #ifdef __cplusplus
- }
- #endif //__cplusplus
-
-
-
- ///////////////////////////////////////////////////////////////////////////
- // ID3DXLine:
- // ------------
- // This object intends to provide an easy way to draw lines using D3D.
- //
- // Begin -
- // Prepares device for drawing lines
- //
- // Draw -
- // Draws a line strip in screen-space.
- // Input is in the form of a array defining points on the line strip. of D3DXVECTOR2
- //
- // DrawTransform -
- // Draws a line in screen-space with a specified input transformation matrix.
- //
- // End -
- // Restores device state to how it was when Begin was called.
- //
- // SetPattern -
- // Applies a stipple pattern to the line. Input is one 32-bit
- // DWORD which describes the stipple pattern. 1 is opaque, 0 is
- // transparent.
- //
- // SetPatternScale -
- // Stretches the stipple pattern in the u direction. Input is one
- // floating-point value. 0.0f is no scaling, whereas 1.0f doubles
- // the length of the stipple pattern.
- //
- // SetWidth -
- // Specifies the thickness of the line in the v direction. Input is
- // one floating-point value.
- //
- // SetAntialias -
- // Toggles line antialiasing. Input is a BOOL.
- // TRUE = Antialiasing on.
- // FALSE = Antialiasing off.
- //
- // SetGLLines -
- // Toggles non-antialiased OpenGL line emulation. Input is a BOOL.
- // TRUE = OpenGL line emulation on.
- // FALSE = OpenGL line emulation off.
- //
- // OpenGL line: Regular line:
- // *\ *\
- // | \ / \
- // | \ *\ \
- // *\ \ \ \
- // \ \ \ \
- // \ * \ *
- // \ | \ /
- // \| *
- // *
- //
- // OnLostDevice, OnResetDevice -
- // Call OnLostDevice() on this object before calling Reset() on the
- // device, so that this object can release any stateblocks and video
- // memory resources. After Reset(), the call OnResetDevice().
- ///////////////////////////////////////////////////////////////////////////
-
-
- typedef interface ID3DXLine ID3DXLine;
- typedef interface ID3DXLine *LPD3DXLINE;
-
-
- // {72CE4D70-CC40-4143-A896-32E50AD2EF35}
- DEFINE_GUID( IID_ID3DXLine,
- 0x72ce4d70, 0xcc40, 0x4143, 0xa8, 0x96, 0x32, 0xe5, 0xa, 0xd2, 0xef, 0x35);
-
- #undef INTERFACE
- #define INTERFACE ID3DXLine
-
- DECLARE_INTERFACE_(ID3DXLine, IUnknown)
- {
- // IUnknown
- STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
- STDMETHOD_(ULONG, AddRef)(THIS) PURE;
- STDMETHOD_(ULONG, Release)(THIS) PURE;
-
- // ID3DXLine
- STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
-
- STDMETHOD(Begin)(THIS) PURE;
-
- STDMETHOD(Draw)(THIS_ CONST D3DXVECTOR2 *pVertexList,
- DWORD dwVertexListCount, D3DCOLOR Color) PURE;
-
- STDMETHOD(DrawTransform)(THIS_ CONST D3DXVECTOR3 *pVertexList,
- DWORD dwVertexListCount, CONST D3DXMATRIX* pTransform,
- D3DCOLOR Color) PURE;
-
- STDMETHOD(SetPattern)(THIS_ DWORD dwPattern) PURE;
- STDMETHOD_(DWORD, GetPattern)(THIS) PURE;
-
- STDMETHOD(SetPatternScale)(THIS_ FLOAT fPatternScale) PURE;
- STDMETHOD_(FLOAT, GetPatternScale)(THIS) PURE;
-
- STDMETHOD(SetWidth)(THIS_ FLOAT fWidth) PURE;
- STDMETHOD_(FLOAT, GetWidth)(THIS) PURE;
-
- STDMETHOD(SetAntialias)(THIS_ BOOL bAntialias) PURE;
- STDMETHOD_(BOOL, GetAntialias)(THIS) PURE;
-
- STDMETHOD(SetGLLines)(THIS_ BOOL bGLLines) PURE;
- STDMETHOD_(BOOL, GetGLLines)(THIS) PURE;
-
- STDMETHOD(End)(THIS) PURE;
-
- STDMETHOD(OnLostDevice)(THIS) PURE;
- STDMETHOD(OnResetDevice)(THIS) PURE;
- };
-
-
- #ifdef __cplusplus
- extern "C" {
- #endif //__cplusplus
-
-
- HRESULT WINAPI
- D3DXCreateLine(
- LPDIRECT3DDEVICE9 pDevice,
- LPD3DXLINE* ppLine);
-
- #ifdef __cplusplus
- }
- #endif //__cplusplus
-
-
-
-
- #endif //__D3DX9CORE_H__
-
-